Skip to content

feat(skills): introduce context extract skill#71

Merged
vidimitrov merged 4 commits intodevelopfrom
feat/extract-skill
Feb 13, 2026
Merged

feat(skills): introduce context extract skill#71
vidimitrov merged 4 commits intodevelopfrom
feat/extract-skill

Conversation

@thenewnickyzz
Copy link
Copy Markdown
Contributor

Introduce infrastructure for bundling Claude Code skills and hooks
during init and upgrade workflows:

  • Add settings-merge utility for additive merging of Claude settings
  • Add buildforce-context-extract skill for automatic context extraction
  • Add hooks config template with Stop hook triggering context extraction
  • Update init/upgrade to merge Claude settings and manage skills
  • Update release packaging to bundle skills into Claude packages

How to test

Build something with claude code. At the end you should see the buildforce-context-extract working.

Introduce infrastructure for bundling Claude Code skills and hooks
@vidimitrov vidimitrov linked an issue Feb 5, 2026 that may be closed by this pull request
25 tasks
Copy link
Copy Markdown
Contributor

@vidimitrov vidimitrov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks great 💪 I am starting to test it locally now, and will add some final feedback once ready

Comment thread .claude/skills/buildforce-context-extract/SKILL.md
Disregard changes that match ANY of:
- Root-level `*.md` files (README, CHANGELOG, etc.)
- Lock files
- Files under `.buildforce/`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might be a little hard filter until we introduce the new plan/build approach


Derive a semantic module name from each directory:
- `src/auth/*` → "authentication"
- `src/templates/commands/*` → "slash-commands"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here might be good to explciitly highlight that these are examples. Agents could easily hallucinate on this instructions


## Step 3: Spawn Extractor Sub-Agents

Use the Task tool to spawn all three extractors in parallel.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you experienced use cases where it doesn't spawn the sub-agents at all? I am highly skeptical how the skill will spawn the correct sub-agents without explicit instruction. But what is more concerning is that we don't create the _extraction-progress.yaml for each sub-agent and they already expect to read it.

If partial failure:
```
⚠️ Context partially updated: {success_count} file(s), {error_count} extractor(s) failed
• Run /buildforce.extract to retry
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we really do that (running a slash command from a skill)? Have you managed to run this failure mode?

Comment thread src/templates/hooks/config.json Outdated
"hooks": [
{
"type": "agent",
"prompt": "Call the buildforce-context-extract skill",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should definitely add a lot more "CRITICAL", "IMPORTANT", etc. guardrails inside the skill, so it doesn't trigger unless really needed. Otherwise, users will be very annoyed 😅

Comment thread src/templates/commands/extract.md Outdated
| deep | Full rationale | Expert |

Context: {$ARGUMENTS}
Call the buildforce-context-extract skill with these arguments: $ARGUMENTS
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need the slash command anymore, as the skill is user-invocable. Let's remove this one and rename the skill accordingly


---

## Step 1: Cold Start Mode
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Potentially we can break each mode into a separate file. Skills are already recommending that.

@vidimitrov vidimitrov changed the base branch from main to develop February 12, 2026 10:10
Remove extract command as it is redundant now that we have the skill
@vidimitrov vidimitrov merged commit 60260fb into develop Feb 13, 2026
1 check passed
@vidimitrov vidimitrov deleted the feat/extract-skill branch February 13, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Context Contribution skill

2 participants